This page documents version 1.2 of the Motif library.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
Label is an instantiable widget and is also used as a
superclass for other button widgets, such as PushButton and
ToggleButton. The Label widget does not accept any button
or key input, and the help callback is the only callback
defined. Label also receives enter and leave events.
Label can contain either text or a pixmap. Label text is a
compound string. Refer to the _O_S_F/_M_o_t_i_f _P_r_o_g_r_a_m_m_e_r'_s Guide
for more information on compound strings. The text can be
multilingual, multiline, and/or multifont. When a Label is
insensitive, its text is stippled, or the user-supplied
insensitive pixmap is displayed.
Label supports both accelerators and mnemonics primarily for
use in Label subclass widgets that are contained in menus.
Mnemonics are available in a menu system when the button is
visible. Accelerators in a menu system are accessible even
when the button is not visible. The Label widget displays
the mnemonic by underlining the first matching character in
the text string. The accelerator is displayed as a text
string adjacent to the label text or pixmap.
Label consists of many margin fields surrounding the text or
pixmap. These margin fields are resources that may be set
by the user, but Label subclasses and Manager parents also
modify some of these fields. They tend to modify the
XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnLLLLeeeefffftttt, XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnRRRRiiiigggghhhhtttt, XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnTTTToooopppp, and
XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnBBBBoooottttttttoooommmm resources and leave the XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnWWWWiiiiddddtttthhhh and
XXXXmmmmNNNNmmmmaaaarrrrggggiiiinnnnHHHHeeeeiiiigggghhhhtttt resources as set by the application.
Label takes into account XXXXmmmmNNNNsssshhhhaaaaddddoooowwwwTTTThhhhiiiicccckkkknnnneeeessssssss in determining
its layout but does not draw the shadow. That is, if
XXXXmmmmNNNNsssshhhhaaaaddddoooowwwwTTTThhhhiiiicccckkkknnnneeeessssssss is greater than 0, Label leaves space for
the shadow, but the shadow does not appear.
In a Label XXXXmmmmNNNNttttrrrraaaavvvveeeerrrrssssaaaallllOOOOnnnn and XXXXmmmmNNNNhhhhiiiigggghhhhlllliiiigggghhhhttttOOOOnnnnEEEEnnnntttteeeerrrr are forced
to False inside Popup MenuPanes, Pulldown MenuPanes, and
OptionMenus. Otherwise these resources default to False.
CCCCllllaaaasssssssseeeessss
Label inherits behavior and resources from CCCCoooorrrreeee and
+o XXXXmmmmAAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT____EEEENNNNDDDD (right alignment)-causes the
right sides of the lines of text to be
vertically aligned with the right edge of the
widget window. For a pixmap, its right side
is vertically aligned with the right edge of
the widget window.
The above descriptions for text are correct when
XXXXmmmmNNNNssssttttrrrriiiinnnnggggDDDDiiiirrrreeeeccccttttiiiioooonnnn is XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG____DDDDIIIIRRRREEEECCCCTTTTIIIIOOOONNNN____LLLL____TTTTOOOO____RRRR.
When that resource is XXXXmmmmSSSSTTTTRRRRIIIINNNNGGGG____DDDDIIIIRRRREEEECCCCTTTTIIIIOOOONNNN____RRRR____TTTTOOOO____LLLL,
the descriptions for XXXXmmmmAAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT____BBBBEEEEGGGGIIIINNNNNNNNIIIINNNNGGGG and
XXXXmmmmAAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT____EEEENNNNDDDD are switched.
If the parent is a RowColumn whose XXXXmmmmNNNNiiiissssAAAAlllliiiiggggnnnneeeedddd
resource is True, XXXXmmmmNNNNaaaalllliiiiggggnnnnmmmmeeeennnntttt is forced to the
same value as the RowColumn's XXXXmmmmNNNNeeeennnnttttrrrryyyyAAAAlllliiiiggggnnnnmmmmeeeennnntttt if
the RowColumn's XXXXmmmmNNNNrrrroooowwwwCCCCoooolllluuuummmmnnnnTTTTyyyyppppeeee is XXXXmmmmWWWWOOOORRRRKKKK____AAAARRRREEEEAAAA or
if the widget is a subclass of XmLabel.
Otherwise, the default is XXXXmmmmAAAALLLLIIIIGGGGNNNNMMMMEEEENNNNTTTT____CCCCEEEENNNNTTTTEEEERRRR.
XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCrrrreeeeaaaatttteeee((((3333XXXX)))), XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCrrrreeeeaaaatttteeeeLLLLttttooooRRRR((((3333XXXX)))), and